home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 August: Tool Chest / Dev.CD Aug 00 TC Disk 2.toast / pc / sample code / overview / tesample / readme < prev    next >
Encoding:
Text File  |  2000-06-23  |  4.2 KB  |  112 lines
  1. Macintosh
  2. Sample Code Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. #2:    TESample
  7.  
  8. Written by:    Mark Bennett, Rick Blair, and Dave Radcliffe
  9.  
  10. Versions:            1.00                        August 1988
  11.                     1.01                        November 1988
  12.                     1.02                        April 1989
  13.                     1.03                        June 1989
  14.                     1.04                        June 1992
  15.  
  16. Components:            TESample.p                    June 1, 1989
  17.                     TESample.c                    June 1, 1989
  18.                     TESampleInit.c                June 4, 1992
  19.                     TESampleGlue.a                June 1, 1989
  20.                     TESample.r                    June 1, 1989
  21.                     TESample.h                    June 1, 1989
  22.                     PTESample.make                June 1, 1989
  23.                     CTESample.make                June 1, 1989
  24.                     TCTESample.π                June 4, 1992
  25.                     TCTESample.π.rsrc            June 4, 1992
  26.                     TCTESampleGlue.c            June 4, 1992
  27.  
  28. A/UX Components:    Makefile                    June 1, 1989
  29.                     TESampleAUX.c                June 1, 1989
  30.                     TESampleInitAUX.c            June 1, 1989
  31.                     TESample.h                    June 1, 1989
  32.                     TESampleGlue.s                June 1, 1989
  33.                     TESample.r                    June 1, 1989
  34.  
  35. _____________________________________________________________________________
  36.  
  37. Major changes with 1.01
  38. ________________________
  39.  
  40. Revamped the way that memory availability is checked and handled 
  41. at initialization.  Substantially changed the way windows are 
  42. closed.  Added an error message dialog to better inform users, and 
  43. improved error handling in general.  Finally, put a funny hack 
  44. into the C version so we could call _PurgeSpace under MPW 2.0.2.
  45.  
  46. Search for “1.01” in the code to find all the specific changes.
  47.  
  48.  
  49. Major changes with 1.02
  50. ________________________
  51.  
  52. Removed all dependencies on MPW 2.0; this version requires MPW 3.0 
  53. or later.  Improved TrapAvailable to handle differences between 
  54. machines prior to the Macintosh II and the Macintosh II and later 
  55. models.
  56.  
  57. Search for “1.02” in the code to find all the specific changes.
  58.  
  59.  
  60. Major changes with 1.04
  61. _______________________
  62.  
  63. This version requires MPW 3.2, THINK C 5.0, or A/UX 3.0 or later.
  64. TESample now works with THINK C 5.0.
  65. This involved separating TESample.c, the original C version, into two
  66. separate files, one for segment Main, and one for Segment Initialize.
  67. This was due to the way that THINK C handles its segmentation.
  68. Also a THINK C project file and resource (.rsrc) file were created.
  69. Finally, the TESampleGlue.a assembly source was converted to THINK C
  70. inline assembly in the file TCTESampleGlue.c.
  71.  
  72. Also see A/UX version notes, below.
  73.  
  74. _____________________________________________________________________________
  75.  
  76. TESample is an example application that demonstrates how to
  77. initialize the commonly used Toolbox managers, operate
  78. successfully under MultiFinder, handle desk accessories, and
  79. create, grow, and zoom windows.  It demonstrates fundamental
  80. TextEdit toolbox calls and TextEdit automatic scrolling, and
  81. it shows how to create and maintain scroll bar controls.
  82.  
  83. It does not, by any means, demonstrate all the techniques you need 
  84. for a large application.  In particular, TESample does not cover 
  85. exception handling, multiple windows or documents, sophisticated 
  86. memory management, printing, or undo, all of which are vital parts 
  87. of a normal full-sized application.
  88.  
  89. This application is an example of the form of a Macintosh 
  90. application; it is not a template.  It is not intended to be used 
  91. as a foundation for the next world-class, best-selling, 600K 
  92. application.  A stick figure drawing of the human body may be a 
  93. good example of the form for a painting, but that does not mean it 
  94. should be used as the basis for the next Mona Lisa.
  95.  
  96. We recommend that you review this program or Sample before 
  97. beginning a new application.
  98.  
  99.  
  100. A/UX Version Notes
  101. __________________
  102.  
  103. The A/UX version was placed into a separate folder as it shares few
  104. files with the MPW C and THINK C versions.  This is largely because
  105. the A/UX cc compiler will not accept the new style ANSI function
  106. header style.  If you own the A/UX developer's tools with c89, you
  107. should be able to use the source files for MPW C.
  108.  
  109. Note that at this time you can not use A/UX to develop native Macintosh
  110. applications as the A/UX linker creates UNIX format executables which
  111. are not compatable without A/UX.  You may, as this sample demonstrates,
  112. develop Macintosh toolbox applications that run on a Macintosh with A/UX.